How to install Redis Stack on macOS
To install Redis Stack on macOS, use Homebrew. Make sure that you have Homebrew installed before starting on the installation instructions below.
There are three brew casks available.
redis-stack contains both redis-stack-server and redis-stack-redisinsight casks.redis-stack-server provides Redis Stack server only.redis-stack-redisinsight contains Redis Insight.Install using HomebrewFirst, tap the Redis Stack Homebrew tap:
brew tap redis-stack/redis-stackNext, run brew install:
brew install redis-stackThe redis-stack-server cask will install all Redis and Redis Stack binaries. How you run these binaries depends on whether you already have Redis installed on your system.
First-time Redis installationIf this is the first time you've installed Redis on your system, you need to be sure that your PATH variable includes the Redis Stack installation location. This location is either /opt/homebrew/bin for Apple silicon Macs or /usr/local/bin for Intel-based Macs.
To check this, run:
echo $PATHThen, confirm that the output contains /opt/homebrew/bin (Apple silicon Macs) or /usr/local/bin (Intel Mac). If these directories are not in the output, see the "Existing Redis installation" instructions below.
Note: Because Redis Stack is installed using a brew cask via the brew tap command, it will not be integrated with the brew services command.Existing Redis installationIf you have an existing Redis installation on your system, then might want to modify your $PATH to ensure that you're using the latest Redis Stack binaries.
Open the file ~/.bashrc or ~/zshrc (depending on your shell), and add the following lines.
For Intel-based Macs:
export PATH=/usr/local/Caskroom/redis-stack-server//bin:$PATHFor Apple silicon Macs:
export PATH=/opt/homebrew/Caskroom/redis-stack-server//bin:$PATHIn both cases, replace with your version of Redis Stack. For example, with version 6.2.0, path is as follows:
export PATH=/opt/homebrew/Caskroom/redis-stack-server/6.2.0/bin:$PATHStart Redis Stack ServerYou can now start Redis Stack Server as follows:
redis-stack-serverInstalling Redis after installing Redis StackIf you've already installed Redis Stack with Homebrew and then try to install Redis with brew install redis, you may encounter errors like the following:
Error: The brew link step did not complete successfullyThe formula built, but is not symlinked into /usr/localCould not symlink bin/redis-benchmarkTarget /usr/local/bin/redis-benchmarkalready exists. You may want to remove it:rm '/usr/local/bin/redis-benchmark'To force the link and overwrite all conflicting files:brew link --overwrite redisTo list all files that would be deleted:brew link --overwrite --dry-run redisIn this case, you can overwrite the Redis binaries installed by Redis Stack by running:
brew link --overwrite redisHowever, Redis Stack Server will still be installed. To uninstall Redis Stack Server, see below.
Uninstall Redis StackTo uninstall Redis Stack, run:
brew uninstall redis-stack-redisinsight redis-stack-server redis-stackbrew untap redis-stack/redis-stackConnect to RedisOnce Redis is running, you can test it by running redis-cli:
redis-cliTest the connection with the ping command:
127.0.0.1:6379> pingPONGYou can also test that your Redis server is running usingRedis Insight.
Next stepsOnce you have a running Redis instance, you may want to:
Try the Redis CLI tutorialConnect using one of the Redis clientsInstall Redis "properly"for production use.